package com.hmall.cart.client;


import com.hmall.api.client.fallback.ItemClientFallbackFactory;
import com.hmall.api.dto.ItemDTO;
import com.hmall.api.dto.OrderDetailDTO;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.Collection;
import java.util.List;

/**
 * 使用FeignClient注解声明这是一个Feign客户端，用于调用名为"item-service"的服务
 * 当调用失败时，使用ItemClientFallbackFactory类提供的降级逻辑
 */
@FeignClient(value = "item-service", fallbackFactory = ItemClientFallbackFactory.class)// 服务名
public interface ItemClient {

    /**
     * 根据商品ID列表查询商品信息
     *
     * @param ids 商品ID集合，用于查询商品
     * @return 返回一个ItemDTO对象列表，包含查询到的商品信息
     */
    @GetMapping("/items")
    List<ItemDTO> queryItemByIds(@RequestParam("ids")Collection<Long> ids);

    /**
     * 扣减商品库存
     *
     * @param items 订单详情列表，包含需要扣减库存的商品信息
     */
    @PutMapping("/items/stock/deduct")
    void deductStock(@RequestBody List<OrderDetailDTO> items);
}

